home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / one_jack.lzh / ONE_JACK.TXT < prev   
Text File  |  1994-05-11  |  19KB  |  467 lines
  1.  
  2.  
  3.  
  4.  
  5.                    __             ////             /// //
  6.                   / ')             //   ////   /// // //
  7.                  /  / ___   _      //  //  // //   ////
  8.                 (__/ / / <_</_  // //  ////// //   // //
  9.                                  ///   //  //  /// //  //
  10.  
  11.  
  12.  
  13.         From the programmers of Mnilu - the GfA v2 compiler
  14.                             &   SuperView - the Desktop file-viewer
  15.  
  16.                 comes
  17.  
  18.                            O n e   J a c k
  19.  
  20.  
  21.  
  22.         Welcome to One  Jack  ,a  different  kind  of program launcher
  23. which  supports  virtually  all  TOS   versions  and  all  replacement
  24. desktops. In a way it becomes an integral part of the pexec call.
  25.  
  26.  
  27.         A computer is a useless machine  if you  don't have any decent
  28. software for it and there also have  to be software from where one can
  29. launch the software. Now the ST range  of machines have always had the
  30. Desktop which led one run the program.  But if someone had hundreds of
  31. folders on a harddrive then  of  course  searching through all of them
  32. can be a big problem. There are many program-launcher now days and the
  33. enhanced desktop on TOS 2+ /  replacement  desktops also allows one to
  34. run a program from hot-keys ( installing program on function keys etc.
  35. ). The problem is to remember which key refere to which program .. .
  36.         Problem which different program-laucher  is  that  you have to
  37. say good-bye to the Desktop.
  38.  
  39.         One Jack attempts to solve some  of  these problems and uses a
  40. very differnt  approach.  The  program  works  as  an  accessory.  The
  41. question : "An accessory can't run a GEM program" ,may be coming up ..
  42. . but we'll come to that later.
  43.  
  44.  
  45.  
  46. Installation
  47. """"""""""""
  48.  
  49.         Since One Jack is  an  accessory  simply copy ONE_JACK.ACC and
  50. ONE_JACK.RSC to the root-directory of  a  disk  and reboot ,or load up
  51. ONE_JACK.ACC in one of the accessory loaders.
  52.  
  53.         1_JRUN.PRG , 1_JRUN.TOS ,1_JRUN.TTP  and 1_JRUN.GTP should all
  54. be copied to the root directory of a  disk. Note : These are all DUMMY
  55. programs!!! But  still  they  should  be  there  ,and  should  also be
  56. preferably installed on Function keys. If  you never use (for example)
  57. .GTP programs then this can be deleted from the disk.
  58.  
  59.         Now select One Jack from the acc menu.
  60.  
  61.  
  62. Use
  63. """
  64.  
  65.         The first time you'll  select  One  Jack  a short postcardware
  66. reminder will come up. Click on OK.
  67.         Now the main menu will appear ,here you'll see 33 boxes(slots)
  68. ,which should all  be  empty  (unless  a  ONE_JACK.JSM  file was auto-
  69. loaded) .
  70.  
  71.         If the slot was not empty (and you clicked on a slot) then the
  72. file (corresponding to the slot) will  be selected (ready to run) ,and
  73. One Jack will exit. To actually run the program click on x_JRUN.nnn. x
  74. may be 1 or A ,nnn may be  PRG,TOS,TTP or GTP (see below for more info
  75. abou this).
  76.         If you wan't to reedit  an  not  empty  slot  then hold down a
  77. [Shift] key while clicking on the slot.
  78. Note: x_JRUN.nnn are ALL DUMMY programs.  They require NO loading (and
  79. of course no extra memory) at all  ,and  can be replaced with any file
  80. of any kind!!!!
  81.  
  82.  
  83. Upto 66 program files may at once be in the memory. To access the next
  84. 33 slots click on the - up and down arrow button - which you'll see on
  85. the bottom right corner. To come back to the first 33 slots reclick on
  86. the up-down-arrow button.
  87.  
  88.  
  89.         To install a program simply  click  on  any of the empty slots
  90. ,either in the first 33-boxes or  the last 33-boxes. The file-selector
  91. will pop-up. Select a file (.PRG,.APP,.GTP,.TOS or .TTP). and click on
  92. OK. Now the prgoram installer menu will come up.
  93.  
  94. Following settings may be altered:
  95.  
  96.  
  97.         Heading:  This is the heading  which  will be displayed in the
  98. slot ,it doesn't have any other  meaning  at  all. It can be any thing
  99. from the name  of  program  (XX.PRG)  or  (Xx)  or  whatever you like.
  100. Clicking on Centre will centre the heading for you!
  101.  
  102.         File: The file name ,with  the  full directory should be here.
  103. This will automatically be selected so you don't really need to fiddle
  104. with that. The file name can also be selected by Selcet (see below)
  105.  
  106.         Select: Clicking on this will  bring  up the fileselector ,and
  107. the file selected from here will be displayed in the File: (see above)
  108. place.
  109.  
  110.         Directory: Here you can select  between [Leave alone] and [Set
  111. to file]..
  112.           [Leave alone]: If you select  this then the setted directory
  113. will NOT be altered at all.
  114.           [Set to file]: The directory will  always be set to the file
  115. to run (when you execute the program by x_JRUN.xxx)
  116.  
  117.                 As an example  you  have  a  file D:\EDITOR\EDITOR.PRG
  118. installed in a slot. If  you  select  [Leave alone] the directory will
  119. not be altered. Now when you run  say 1_JRUN.PRG and the directory way
  120. E:\ASM\DEVPAC\ then the  E:\ASM\DEVPAC\  directory  will  be selected.
  121. This _can_ make -Resource file not found- errors.
  122.                 On the other side if  you  had  selected [Set to file]
  123. and  run  1_JRUN.PRG  then  the  directory   will  always  be  set  to
  124. D:\EDITOR\.
  125.                 If you don't understand it  much  then simply leave it
  126. as [Set to file].
  127.  
  128.  
  129.         The next options are Parameters :
  130.                 [No] : No pre-defined  parameters.  If  you will enter
  131. any parameters in the .GTP ,.TTP  dialog then the same parameters will
  132. be passed to calling application. Otherwise One Jack won't do anything
  133. with them.
  134.                 [Ask]: When you'll click on  the  slot of this program
  135. then a dialog-box will come  up  ,asking  for  any parameters. All put
  136. commands are also interrupted (see below).
  137.  
  138.                 [Defined] : Enter the parameters  in the editable line
  139. next to this option and  the  same  parameters  will  be passed to the
  140. application. No need  to  reenter  the  parameters  ,as  they  will be
  141. remembered! All put commands are also interrupted (see below).
  142.  
  143.         Click on [OK] to exit back to the main menu.
  144.         Clicking on  [Select  this]  will  automatically  select  this
  145. program ,One Jack will exit and  the  prgoram  will be ready to run by
  146. x_JRUN.nnn.
  147.  
  148.         At the main menu (If you  are  there)  clcik  on a sot where a
  149. file has been installed and click  on  it  to select it. One Jack will
  150. now exit and the prgoram will be ready to run by x_JRUN.nnn.
  151.  
  152.  
  153.         The selected program may  now  be  run  by  double clicking as
  154. normal on 1_JRUN.PRG  ,1_JRUN.TOS,1_JRUN.TTP  or  1_JRUN.GTP. As these
  155. programs are just 'dummies' they  won't  load  at  all ,and in reality
  156. your program will run instantly! If you have installed x_JRUN.nnn on a
  157. function key then it's a simple matter  to press that function key. If
  158. your desktop allows it  then  these  programs  can  be  dragged to the
  159. dektop.
  160.         Anyway all x_JRUN.nnn start with 1  or  A  (  x=1 or x=A ) and
  161. they will normaly be displayed in the top of the window.
  162.  
  163.  
  164.         Put commands:
  165.         =============
  166.  
  167.                 In all parameters you may  enter special 'commands' to
  168. do something special. These all start with an %.
  169.  
  170. %p ,%f:
  171.         To input a file name selected  using  the file selector use %f
  172. or %p. The file selector will come up when you [Select this] ,or click
  173. on the slot where (%f,%p) is prefdeined  as  parameter : %f : Only the
  174. file name will be passed. %p :  Both  the file name and directory will
  175. be passed.
  176.  
  177.         Example
  178.  
  179.                 You  have   a   pre-defined   text   as   :   %p   for
  180. D:\EDITOR\EDITOR.PRG.  Now  when  you  will  click  on  the  slot  for
  181. EDITOR.PRG then the file selector will  come  up and the file selected
  182. will be passed (full directory) to EDITOR.PRG when you run x_JRUN.nnn.
  183.  
  184.                 Things  can  be  made  complicated.  Normally  to  get
  185. verbose listning in a LZH file you enter parameters as :
  186. v -h file.lzh *.* . For LHARC.TTP pre-define the text as :
  187. v -h %p *.*. Now whenever you'll  click  on the slot for LHARC.TTP the
  188. file selector will come up. Select the  file tp verbose list and click
  189. on Ok. The next th